home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / cctrx40.zip / CCTRX.DOC < prev    next >
Text File  |  1992-06-30  |  10KB  |  227 lines
  1.  
  2.  
  3.                         The CC-TRX Credit Card Door 4.0
  4.                                for RemoteAccess
  5.                      Copyright 1991, 1992 by Randy Blackmond
  6.                               All Rights Reserved
  7.  
  8.     The CC-TRX Credit Card Door allows you to accept credit card purchases on
  9.     your BBS! The transactions can be for products or services such as share-
  10.     ware registrations, BBS subscriptions or merchandise! The door is fully
  11.     sysop configurable so you may accept any credit card for any item!
  12.  
  13.     Features:
  14.       1) Up to 9 credit cards can be configured
  15.       2) Unlimited number of transaction items can be configured
  16.       3) A sales tax (or other markup) percentage can be configured per item
  17.       4) A shipping or other flat rate charge can be configured per item
  18.       5) A shipping address prompt can be configured per item
  19.       6) Users' security can be upgraded per item
  20.       7) Users' flags can be modified per item
  21.       8) Users' subscription expiration date can be modified per item
  22.       9) A voice phone number prompt can be configured globally
  23.      10) Optional Visa and MasterCard number validation using the 
  24.          Modulus 10 Luhn formula
  25.      11) An external program can optionally be run after a transaction
  26.  
  27.     INSTALLATION
  28.     ------------
  29.     The first thing you need to do is make sure the RA environment variable
  30.     is set via your AUTOEXEC.BAT or BBS batch file. This is done by assigning
  31.     your RA system directory to the RA variable with the following DOS command:
  32.     
  33.     SET RA=<directory>
  34.  
  35.     For example, my RA system directory is G:\RA so my Set line would be as
  36.     follows:
  37.  
  38.     SET RA=G:\RA
  39.  
  40.     Next, copy CCTRX.EXE and CCTRXCFG.EXE to either your RA system directory 
  41.     or create a separate directory for CC-TRX.
  42.  
  43.     Run CCTRXCFG.EXE to create/edit the configuration file for CC-TRX. The 
  44.     name of the configuration file is CCTRX.CFG.
  45.  
  46.     Add CC-TRX to the menu of your choice with the following Optional Data
  47.     line (if CCTRX.EXE resides in your RA system directory):
  48.  
  49.     CCTRX.EXE *M
  50.  
  51.     The *M is optional, but will ensure there is plenty of memory available 
  52.     for CC-TRX to use so it is recommended.
  53.  
  54.     If you created a separate directory for CC-TRX, you will need to create
  55.     a batch file containing the commands to change to the CC-TRX directory
  56.     and execute CC-TRX. This method can be used with either a type 7 or type
  57.     15 shell.
  58.  
  59.     All transactions made in the CC-TRX Door are written to a text file named
  60.     CCTRX.TRX.
  61.  
  62.     
  63.     
  64.     There are nine optional, external display files you may create to be used
  65.     by CC-TRX. They follow the ASC/ANS naming convention for RA display files,
  66.     but must reside in the same directory as CCTRX.EXE. The files are displayed
  67.     with More prompting. They are as follows:
  68.  
  69.     CCMENU.A*  - The menu files for CC-TRX.
  70.     
  71.     CCWELC.A*  - This file is displayed immediately after the opening CC-TRX
  72.                  title screen.
  73.     
  74.     CCSAVED.A* - This file is displayed after a successful transaction has
  75.                  been saved.
  76.  
  77.     CCCARD.A*  - This file is displayed before the user is prompted to select
  78.                  which credit card they wish to use.
  79.  
  80.     CCTRANS.A* - This file is displayed after the user selects "Perform Credit
  81.                  Card Transaction" from the CC-TRX menu.
  82.     
  83.     CCBADCC.A* - This file is displayed when a user enters a Visa or 
  84.                  MasterCard that fails the validation check (when the Refuse
  85.                  Invalid toggle is enabled).
  86.     
  87.     CCFILE1.A* - This file is displayed if the user presses '1' at the menu.
  88.                  Automatic More prompting is used.
  89.  
  90.     CCFILE2.A* - This file is displayed if the user presses '2' at the menu.
  91.                  Automatic More prompting is used.
  92.  
  93.     CCFILE3.A* - This file is displayed if the user presses '3' at the menu.
  94.                  Automatic More prompting is used.
  95.  
  96.     These files can include some of the control-codes used by RA such as the
  97.     clear-screen, pause, user name, etc. Those which are not supported will
  98.     be displayed as N/A.
  99.  
  100.     EXTERNAL PROGRAM
  101.     ----------------
  102.     The external program, if enabled, can be and do anything you like.
  103.  
  104.     CC-TRX will pass two parameters to the external program. The first is
  105.     the user name in the form FirstName_LastName (note the underscore). The
  106.     second parameter is the number of the transaction item they selected.
  107.  
  108.     Of course, if you're not a programmer, this option won't do you much good.
  109.     However, if you so desire, I will write a custom program for you to do
  110.     what you want for $20.00. The only restrictions are that the program not
  111.     be TOO complex and that you have registered CC-TRX. Now, my definition
  112.     and your definition of "Too Complex" may not be the same, so shoot your
  113.     idea to me and I'll be glad to give it consideration. Also, any custom
  114.     program written by me will remain my property and will be copyrighted by
  115.     me. The reason I do this is someone may give me an idea that I may want
  116.     to incorporate as an added feature in a future version of CC-TRX.
  117.  
  118.  
  119.  
  120.     NOTE
  121.     ----
  122.     As stated above, CC-TRX uses the Modulus 10 Luhn Formula for validating
  123.     Visa and MasterCard numbers. I and others have discovered that many
  124.     Visa cards use a different method of check-digit calculation and will
  125.     therefore fail a verification check. The options to overcome this until
  126.     I can discover the new check-digit formula are as follows:
  127.     
  128.     1) Do not enable validation check for Visa cards.
  129.     2) Enable validation checks for Visa, but disable the 'Refuse Invalid
  130.        Visa/MC' toggle.
  131.     3) Enable the validation and refusal options and use the CCBADCC.A* display
  132.        file to instruct the user to leave you the order/card information in
  133.        a message for manual processing.
  134.  
  135.     SUPPORT/SUGGESTIONS
  136.     -------------------
  137.     As with all of my shareware products, I strongly urge users to offer sug-
  138.     gestions for further enhancement of my software. Without suggestions, a
  139.     program will whither and die. WITH suggestions, a program can grow and
  140.     become an even more useful tool!
  141.  
  142.     If you have any problems setting up CC-TRX, have a bug to report or want
  143.     to offer a suggestion for future versions, you can contact me in several
  144.     ways: Via FIDO NetMail at 1:381/70, Via FIDO EchoMail in the RA_UTILS
  145.     echo, call my BBS at 505-589-0319 USR DS and leave a message or call my 
  146.     voice line at 505-589-0317 24 hours (answering machine on duty).
  147.     
  148.     Be sure to check out RAMail, THE QWK Compatible MailDoor for RA, and
  149.     Txt2Msg for RA!
  150.  
  151.     HISTORY
  152.     -------
  153.     1.0   Initial Release of CC-TRX!
  154.  
  155.     2.0   Added User Flag Setting and External Program support. Fixed bug
  156.           that limited transaction selection to 9 instead of 75.
  157.  
  158.     2.1   Fixed Bug that caused Flags to be set exactly as shown in the CFG
  159.           file. It was supposed to only turn on flags set in the CFG, not
  160.           turn off flags not set! Works properly now. Due to the unreliability
  161.           of the Luhn validation method, the user is merely warned when a
  162.           card number is flagged as invalid, but is allowed to continue the
  163.           transaction.
  164.  
  165.     2.2   Fixed bug that occurred when more than 9 transaction items were
  166.           configured. The card number validation routine for Visa and
  167.           Mastercard (the Luhn Formula) has been fixed.
  168.  
  169.     3.0   Included a configuration program to ease CC-TRX configuration.
  170.           Added Subscription Expiration Date modification. The number of
  171.           transaction items you may configure is now unlimited.
  172.  
  173.     3.1   Just a couple of bug fixes for this version. Pause was added to 
  174.           each screenful display of TRX items. TRX count was erroneously
  175.           being used to determine the number of valid responses to the
  176.           credit card number selection, i.e. if you had only 2 TRX items
  177.           configured, a user could not select a credit card numbered above
  178.           2!
  179.  
  180.  
  181.  
  182.     4.0   Added ability for user to select multiple items without having to
  183.           enter credit card info for each item. Added a quantity prompt for
  184.           each item. User can add or delete items after completing selections.
  185.           A message is written to the user after a successful transaction
  186.           showing all information about his transaction. This message is
  187.           placed on Board 1 as a private message.
  188.     
  189.     DISCLAIMER
  190.     ----------
  191.     I make no guarantees to the suitability or functionality of CC-TRX on your
  192.     system nor will I be held liable for any damages caused to you or your
  193.     system directly or indirectly by CC-TRX. I will, however, assist you to
  194.     the best of my ability to get CC-TRX running for you should you need
  195.     assistance. USE AT YOUR OWN RISK!
  196.  
  197.     REGISTRATION
  198.     ------------
  199.     CC-TRX is a shareware product, which means you try before you buy. If you
  200.     use CC-TRX beyond a 2 week evaluation period, you are required to register
  201.     it with the author. Complete and mail the following registration form with
  202.     a check or money order. 
  203.  
  204.     Randy Blackmond                               CC-TRX Credit Card Door v4.0
  205.     RR #1 Box 634                                            Registration Form
  206.     Anthony, NM 88021
  207.  
  208.     CC-TRX 4.0 is $20.00 US/$25.00 INTERNATIONAL
  209.  
  210.     YOUR NAME _____________________________ YOUR VOICE PHONE _________________
  211.  
  212.     YOUR BBS NAME ___________________________ YOUR BBS PHONE _________________
  213.  
  214.     BAUD RATES SUPPORTED ___________________ 
  215.  
  216.     ARE YOU IN FIDO? IF SO, YOUR NODE ADDRESS ________________
  217.  
  218.     ARE YOU IN RIME? IF SO, YOUR NODE ID ________________
  219.  
  220.     COMMENTS/SUGGESTIONS _____________________________________________________
  221.  
  222.     __________________________________________________________________________
  223.  
  224.     __________________________________________________________________________
  225.  
  226.     
  227.